home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 036a / syscols.zip / SYSCOLS.HLP (.txt) < prev    next >
OS/2 Help File  |  1991-06-22  |  11KB  |  383 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. PM System Color Keys ΓòÉΓòÉΓòÉ
  3.  
  4. Accelerator mnemonic keys: 
  5.  
  6. F3 
  7.    Exit 
  8.  
  9. F1 
  10.    Help 
  11.  
  12. R 
  13.    Reset 
  14.  
  15. D 
  16.    reaD 
  17.  
  18. K 
  19.    Keep 
  20.  
  21. W 
  22.    Write 
  23.  
  24. S 
  25.    Set 
  26.  
  27. L 
  28.    deLete 
  29.  
  30. T 
  31.    seT 
  32.  
  33. V 
  34.    saVe 
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ 2. Extended Help for PM System Colors ΓòÉΓòÉΓòÉ
  38.  
  39. This program offers configuration of OS/2 Presentation Manager's system colors. 
  40. It offers several advantages over OS/2's Control Panel.  These include: 
  41.  - 32 system colors can be changed whereas the Control Panel only allows 
  42. configuration of 26 colors. 
  43.  - Most color changes are visible immediately. 
  44.  - Sample Color Templates are available.  Additional Templates can be created, 
  45. or existing ones can be modified. 
  46.  - Colors can be set temporarily or permanently. 
  47.  - A color template can be loaded from the command line (ideal for use in .CMD 
  48. files). 
  49.  
  50. The system colors in OS/2 1.x are: 
  51. ButtonLight - Top and left edges of scrollbar slider box 
  52. ButtonMiddle (+) - Scrollbar slider box and pushbuttons 
  53. ButtonDark - Right and botton edges of scroll bar slider box 
  54. ButtonDefault - Outline of default pushbutton 
  55. TitleBottom - Thin line outlining action or menu bar 
  56. Shadow -  Shadow around edge of pull down menus 
  57. IconText -  Text under icons 
  58. DialogBackground (*) -  Background for dialogue boxes 
  59. HiLiteForeground - Text of hilighted selection 
  60. HiLiteBackground (*) - Hilighted selection menu bar 
  61. InActiveTitleTextBgnd (=) - Inactive title-text background 
  62. ActiveTitleTextBgnd (=) - Active title-text background 
  63. InActiveTitleText - Text of menu or action bar on inactive windows 
  64. ActiveTitleText - Text of menu or action bar on active window (window with 
  65. focus) 
  66. OutputText - Appears in dialogue boxes as default text in entry fields 
  67. WindowStaticText - Static window text 
  68. ScrollBar - Background for scroll bar (note: not slider box) 
  69. Background - Screen background 
  70. ActiveTitle - Text on title bar of active window 
  71. InActiveTitle - Text on title bar of inactive window 
  72. Menu - Menu or action bar background 
  73. Window (*) - Background of window 
  74. WindowFrame - Thin border line outlining all windows 
  75. MenuText - Text of menu or action bar 
  76. WindowText - Window normal text 
  77. TitleText - (=) Title text 
  78. ActiveBorder - Border around active window (window with focus) 
  79. InActiveBorder - Border around inactive windows 
  80. AppWorkSpace - Application background 
  81. HelpBackground (*) - Background for help screens 
  82. HelpText - Text for help screens 
  83. HelpHiLite - Highlighted text for help screens 
  84.  
  85. (*) indicates that only pure colors can be applied to this system object 
  86. (+) non-pure colors can be applied to scroll box slider buttons, but not to 
  87. push buttons. 
  88. Apparently, Presentation Manager does it's best to find matching display colors 
  89. for the colors you choose, however for colors applied to certain system 
  90. objects, the results may be different from that displayed in the sample color 
  91. area.  This is most likely due to Presentation Manager's rejection of dithered 
  92. colors for some settings.  Those system objects that do not seem compatible are 
  93. marked with (*). 
  94. (=) On the OS/2 systems I have had experience with, setting colors for these 
  95. system objects has no visible effect.  I'm not positive where these system 
  96. objects appear, but apparently they have something to do with 'Function Key 
  97. Areas'.  At any rate, they are documented as system colors and may very well be 
  98. "reserved for future use"  items.  If anyone can provide  a screen or 
  99. application where these colors appear, I would greatly appreciate the 
  100. information. 
  101.  
  102. Actions for PM System Color Configuration: 
  103.  
  104. The following actions may be invoked by clicking on the pushbutton 
  105. corresponding to the action, or by pressing the letter corresponding to the 
  106. underlined mnemonic character. 
  107.  
  108. R 
  109.    Reset to original colors 
  110.  
  111. D 
  112.    Read data file containing color codes to set 
  113.  
  114. K 
  115.    Keep current screen colors for future sessions (Save to OS/2's .INI file) 
  116.  
  117. W 
  118.    Write current color codes to data file 
  119.  
  120. S 
  121.    Set colors to those defined by the color template selected in the Color 
  122. Templates list box 
  123.  
  124. L 
  125.    Delete color template 
  126.  
  127. T 
  128.    Set system colors object (i.e. Icon Text, Window Text, Background) to the 
  129. color displayed in the sample color region 
  130.  
  131. V 
  132.    Save the currently selected system colors object and the color selected in 
  133. the sample area to an existing or new Color Template 
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 3. Help for Reset ΓòÉΓòÉΓòÉ
  137.  
  138. This action resets the colors back to the ones which were active when this 
  139. program was invoked  (which may or may not be OS/2's original colors depending 
  140. upon if you have changed them with Control Panel). 
  141.  
  142.  
  143. ΓòÉΓòÉΓòÉ 4. Help for Read ΓòÉΓòÉΓòÉ
  144.  
  145. This action reads a data file containing color codes to set.  The data file 
  146. must be a pure ASCII text file containing one line for each of the 32 colors. 
  147. If you like the colors loaded from the data file, use the action Save to save 
  148. the colors to a template name. 
  149.  
  150. The order of the colors in the data file is as follows: 
  151.  
  152.   1. ButtonLight 
  153.  
  154.   2. ButtonMiddle 
  155.  
  156.   3. ButtonDark 
  157.  
  158.   4. ButtonDefault 
  159.  
  160.   5. TitleBottom 
  161.  
  162.   6. Shadow 
  163.  
  164.   7. IconText 
  165.  
  166.   8. DialogBackground 
  167.  
  168.   9. HiLiteForeground 
  169.  
  170.  10. HiLiteBackground 
  171.  
  172.  11. InActiveTitleTextBgnd 
  173.  
  174.  12. ActiveTitleTextBgnd 
  175.  
  176.  13. InActiveTitleText 
  177.  
  178.  14. ActiveTitleText 
  179.  
  180.  15. OutputText 
  181.  
  182.  16. WindowStaticText 
  183.  
  184.  17. ScrollBar 
  185.  
  186.  18. Background 
  187.  
  188.  19. ActiveTitle 
  189.  
  190.  20. InActiveTitle 
  191.  
  192.  21. Menu 
  193.  
  194.  22. Window 
  195.  
  196.  23. WindowFrame 
  197.  
  198.  24. MenuText 
  199.  
  200.  25. WindowText 
  201.  
  202.  26. TitleText 
  203.  
  204.  27. ActiveBorder 
  205.  
  206.  28. InActiveBorder 
  207.  
  208.  29. AppWorkSpace 
  209.  
  210.  30. HelpBackground 
  211.  
  212.  31. HelpText 
  213.  
  214.  32. HelpHiLite 
  215.  
  216.  OS/2 specifies colors with 24 bits of Red-Green-Blue intensity information. 
  217.  Since there are 8 bits for each color, the valid ranges are from 0 to 255. The 
  218.  integers represent the Red, Green, and Blue components of an RGB color value. 
  219.  
  220.  Some example colors are: 
  221.  
  222.   White   255  255  255
  223.   Yellow  255  255    0
  224.   Pink    255    0  255
  225.   Cyan      0  255  255
  226.   Blue      0    0  255
  227.   Green     0  255    0
  228.   Red     255    0    0
  229.   Black     0    0    0
  230.  
  231.  The data file should contain a line for each of the 32 colors in the order 
  232.  outlined above.  The leftmost integer is the Red value, the middle integer is 
  233.  the Green value, and the rightmost integer is the Blue value. 
  234.  
  235.  Sample data file: 
  236.  
  237.   255 255 255
  238.   204 204 204
  239.   128 128 128
  240.     0   0   0
  241.   204 204 204
  242.   128 128 128
  243.     0   0   0
  244.   255 255 255
  245.   255 255 255
  246.     0   0   0
  247.     0   0   0
  248.     0   0   0
  249.     0   0   0
  250.   255 255 255
  251.     0   0   0
  252.     0   0 128
  253.   224 224 224
  254.   192 192 192
  255.     0  64 128
  256.   255 255 255
  257.   255 255 255
  258.   255 255 255
  259.     0   0   0
  260.     0   0   0
  261.     0   0   0
  262.   255 255 255
  263.   128 128 128
  264.   255 255 255
  265.   255 255 232
  266.   255 255 255
  267.     0   0 128
  268.     0 128 128
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 5. Help for Keep ΓòÉΓòÉΓòÉ
  272.  
  273. This action saves the current colors for future sessions by writing to OS/2's 
  274. OS2.INI file.  OS2.INI is an initialization file that OS/2 processes when the 
  275. system is started. 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 6. Help for Set Color Template ΓòÉΓòÉΓòÉ
  279.  
  280. This action sets the system colors to the colors defined by the currently 
  281. highlighted selection in the Color Templates list box. 
  282.  
  283. To reset the colors back to the ones which were active when this program was 
  284. invoked, click the Reset pushbutton. 
  285.  
  286. When the program loads, it searches the current directory for it's own .INI 
  287. file to load the Color Template names.  If the .INI file is not found, a 
  288. message box is displayed. 
  289.  
  290. If you exit (close) this program (without selecting Keep), the colors will 
  291. remain in effect, however, when the system is shutdown and brought back up 
  292. again, the "original" colors will once again be in effect (since the colors 
  293. were not saved to OS/2's OS2.INI file with the Keep action). 
  294.  
  295. A Color Template name can be specified on the command line. If a parameter is 
  296. given on the command line, the interactive Presentation Manager screen will not 
  297. be invoked. 
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 7. Help for Delete ΓòÉΓòÉΓòÉ
  301.  
  302. This action removes a Color Template.  Since you cannot "undelete" a color 
  303. template, you will be prompted to confirm the deletion. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 8. Help for Set System Color Object ΓòÉΓòÉΓòÉ
  307.  
  308. This action sets the currently selected system object (i.e. WindowStaticText, 
  309. ScrollBar, Background, etc.) in the System Colors listbox to the color 
  310. currently displayed in the sample color region.  This action affects only the 
  311. currently selected system object. 
  312. Selecting Reset or Set Color Template will override the individual colors 
  313. previously set with this option. 
  314.  
  315. The Color Template "Different", although some may think it ugly, serves to 
  316. demonstrate each system object as a different color. 
  317.  
  318.  
  319. ΓòÉΓòÉΓòÉ 9. Help for Save to Color Template ΓòÉΓòÉΓòÉ
  320.  
  321. This action saves the current system colors to an existing or new Color 
  322. Template.   The default color template to save to is the one highlighted in the 
  323. Color Templates list box, however, another template can be specified. 
  324.  
  325. To build (or modify) a template, select the system color object in the System 
  326. Colors listbox that you want to change (i.e. Icon Text, WindowText, Background, 
  327. etc.), use the scrollbars to choose a color, then use Set (next to the System 
  328. Colors listbox) to test the color.  Then, optionally, use save to save the 
  329. changes to a Color Template. 
  330.  
  331.  
  332. ΓòÉΓòÉΓòÉ 10. Help for Write Data File ΓòÉΓòÉΓòÉ
  333.  
  334. This action writes the current color setting codes to a file.  This is handy to 
  335. transfer color setting between systems.  If a friend has colors that you would 
  336. like to add to your Color Templates, simply have him/her save their colors to a 
  337. data file, then use Read to load the colors on your system, and optionally save 
  338. them to a Color Template. 
  339.  
  340.  
  341. ΓòÉΓòÉΓòÉ 11. Loading Templates from Command Line ΓòÉΓòÉΓòÉ
  342.  
  343. A Color Template name can be specified on the command line. 
  344. Command line syntax is: 
  345.  
  346. SYSCOLS ["]templatename["] [/L] 
  347.  
  348. where templatename is space-sensitive but not case-sensitive, and /L indicates 
  349. to load the main System Colors Configuration Presentation Manager screen after 
  350. changing the colors. 
  351.  
  352. Specifying Color Templates on the command line without loading the main screen 
  353. is useful for .CMD files, especially if you run a program that conflicts with 
  354. your default color choices.  Simply put the lines 
  355.  
  356. SYSCOLS "newtemplatename" 
  357. <commands to run confliciting program> 
  358. SYSCOLS "default or oldtemplatename" 
  359.  
  360. in a .CMD file to set colors compatible with the program, run the program, and 
  361. then set the colors back to your favorite selection. 
  362.  
  363. No action is taken if the Color Template name given on the command line is not 
  364. found in this program's .INI file.  Note that the Color Template name is not 
  365. case sensitive, but if the Color Template name consists of two or more words, 
  366. the template name must be enclosed in " ". 
  367.  
  368. For example, 
  369. SYSCOLS "Penn State"    is valid 
  370. SYSCOLS "penn state"    is valid 
  371. SYSCOLS "pEnN sTaTe"    is valid 
  372. SYSCOLS penn state    is not valid 
  373. SYSCOLS pennstate    is not valid 
  374. SYSCOLS PennState    is not valid 
  375.  
  376. If a paramter is given on the command line, the program simply searches for the 
  377. Color Template in the .INI file, and if it is found, the system colors are 
  378. changed.  If the template name is not found, the colors do not change. In 
  379. either case, the Presentation Manager interactive screen is not invoked unless 
  380. /l or /L is given as the second parameter. 
  381. SYSCOLS "penn state"  /l   would change the colors and load the program. 
  382. SYSCOLS "invadid template"  /l   would not change the colors, however the main 
  383. System Colors Configuration Presentation Manager screen would be loaded